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About the Velocity Toolkit for Lab VIEW 

The Velocity Toolkit for Lab VIEW contains a library and supporting low level interface code. This 
library contains a set of Lab VIEW Virtual Instruments (Vis) that allow you to control Electrophysics 
PV320 series cameras, and capture frames in a Lab VIEW environment. 

Software requirements: 

• Windows 2000/XP 

• Lab VIEW 7.1 or higher 

• Some Vis require NTs Image processing software “IMAQ Vision” version 7.0 or higher. 

Installing the Velocity Toolkit Library 

In order to insert the Velocity Toolkit library into a Lab VIEW’S function palette, proceed as described 
below: 


Launch Lab VIEW and go to the menu “Tools:Advanced:Edit Palette Views..”. 

Choose a previously-created custom palette or choose “new setup...” and type 
“VelocityToolkitMenu” as the Palette name, and press “OK”. 

In the “Functions” palette, choose “Insert:Submenus...” from the contextual menu. 

Choose “Link to a library (.11)” and click “OK” 

Browse to Velocity Toolkit Installation directory and select “VelocityToolkitLV.llb”. The 
Velocity Toolkit palette is inserted. 

- Click on “Save Changes”. 

Quick steps to acquire a frame 

To acquire a frame from the camera, proceed with the following steps: 

- Open and run the VI SetLicencelnfo with the proper license code. 

Open the VI “ConnectCamera”, set the Boolean “Connect” input to true and run it. If the 
connection succeeded, the “success” boolean changes to green. 

Open the VI “VideoStreaming”, choose “Run” in the mode control and run the VI. 

Open the VI “GetNextPicture” or “GetNextArray” and run the VI. The “New Image” Boolean 
change to green, indicating that a frame has been retrieved. 

Quick steps to exchange parameters with the camera 

To exchange parameters with the camera, proceed with the following steps: 

If not already done, setup the license information and connect the camera (see above). 

Open the VI “CameraParameter”. Choose any relevant command in the “Command” control, for 
instance “Get Model Number”, and run the VI. The “Returned String” contains the camera 
model being connected. 
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Velocity Toolkit VI summary 

In the PPVI library, you will find a set of Vis allowing you to manage different features of the camera. 
The following is a summary of each part, and the associated Vis: 

Camera connection and streaming management 

SetLicencelnfo.vi, ConnectCamera.vi, VideoStreaming.vi, GetHardSoftRevision.vi 

Frame capture 

GetNextlmage.vi, GetNextPicture.vi, GetNextArray.vi, GetVideoSize.vi 

Camera commands 

CameraParameter.vi, WriteReadSerialData.vi, SetVideoMode.vi, SerialDataLog.vi 

Palette generator & Raw pixels to RGB conversion 

Convertl6ToRGB.vi, ConvertArrayl6ToRGB.vi, PaletteGenerator.vi, 

Raw Data (Gray Level) to Temperature Conversion 

GetCalibration.vi, SetCalibration.vi, GetCurrentTempData.vi, ConvertRawTemp.vi 


File access 

WriteReadFITSFile.vi 


Examples 

PVGrabDisplay.vi, PVGrabToPicture.vi. 
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Velocity Toolkit VI details 


SetLicenselnfo.vi 


This VI sets up the license keys codes necessary to allow the connection of any camera. This VI MUST be called 
with success before being able to connect a camera by calling ConnectCamera.vi. 

Connector Pane 

Licenses Keys 
error in (no error) 


. Success 

Cft mxxxxxm error out 


Controls and Indicators 


IrCT 


EID 


Licenses Keys The 11 chars license keys code provided by Electrophysics when 
buying Velocity Toolkit. Several license keys can be passed together separated by a 
space or a tab char. 

Success Return TRUE if license key(s) was successfully loaded. 


ConnectCamera.vi 


This VI establishes the USB connection with the camera. This VI MUST be called with success before being able 
to capture frames or exchange commands with the camera. 

Connector Pane 


Connect (f) 
error in (no error} 


. Success 

Ci< . error out 


Controls and Indicators 


»tf i| Connect specifies whether the camera has to be connected or disconnected. 


»tf i| Success Return TRUE if a camera was successfully connected. 


VideoStreaming. vi 

After connecting the camera, this VI controls the capture of images. 

Connector Pane 


Mode 

error in (no error) 



error out 


Controls and Indicators 
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150 Mode 


Specifies the mode for the video streaming: 


Run launch the asynchronous capture of frames. After setting this mode, frames can be 
retrieved using one of the GetNextxxx Vis. 

Pause temporarily stop the capture of frames. 


GetHardSoftRevision.vi 

Returns the software and hardware revision numbers. 

Connector Pane 


error in (no error) 



Velocity Toolkit Revision 
DLL Revision 
Hardware Revision 
error out 


Controls and Indicators 


11 Velocity Toolkit Revision number 


►*bc 1 1 Software Revision number 


Mbc i Hardware Revision number 


GetNextlmage.vi 

After connecting the camera and enabling video streaming, this VI allows retrieving a frame into an IMAQ Vision 
Image. The VI can optionally wait for a certain time until a new frame is captured. 

Connector Pane 


Image In 
Timeout ms (100) 
error in (no error) 
Wait CTrue) 



XT 


<« 


Image Out 
"'■■■ New Image 
error out 


Controls and Indicators 

ir^H Image In The image being used for the operation. It has to be a 16 bit image. 

150 Wait (True) specifies if the VI should wait for a new frame. If true, this VI returns when a 
new frame is captured or when the time specified by "timeout" is over. If false, the VI 
returns immediately, whether a new frame is captured or not. 

|i Isa ri Timeout ms (100) is the optional amount of time in ms this VI can wait for a new frame. 
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New Image indicates if a new frame was captured. 


GetNextPicture.vi 

After connecting the camera and running the video streaming, this VI allows retrieving a video frame into a 
LabVIEW picture. The VI can optionally wait for a certain time until a new frame is captured. 

Connector Pane 

Color LUT 


Timeout ms (100) 
error in (no error) 
Wait (True) 



^m 



(1 

mnn ^ 





■ Picture Out 


error out 


Controls and Indicators 

GO Wait (True) specifies if the VI should wait for a new frame. If true, this VI returns when a 
new frame is captured or when the time specified by "timeout" is over. If false, the VI 
returns immediately, whether a new frame was captured or not. 

iitmh Timeout ms (100) is the optional amount of time in ms this VI can wait for a new frame. 


converted into RGB according to the content of the color LUT. 


► tf i| New Image indicates if a new frame was captured. 


i| Picture Out RGB representation of the new capture frame (if any). The pixels are 


GetNextArray.vi 


After connecting the camera and running the video streaming, this VI allows retrieving video frame into a 
LabVIEW 2D array. The VI can optionally wait for a certain time until a new frame is captured. 


Connector Pane 

Timeout ms (100) 
error in (no error) 
Wait (True) 



Array Out 
'■■■ New Image 
error out 


Controls and Indicators 


150 


IIT52H 


un 


tH6] | 


Wait (True) specifies if the VI should wait for a new frame. If true, this VI returns when a 
new frame is captured or when the time specified by "timeout" is over. If false, the VI 
returns immediately, whether a new frame was captured or not. 

Timeout ms (100) is the optional amount of time in ms this VI can wait for a new frame. 
New Image indicates if a new frame was captured. 

Array Out pixels of the new captured frame (if any). 
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GetVideoSize.vi 


Returns the size of the frame captured by the camera. 

Connector Pane 


error in (no error) 



size X 
^ size Y 
error out 


Controls and Indicators 


1 size X returns the width of the frame. 


►132 1 1 size Y returns the height of the frame 


CameraParameter.vi 


After connecting the camera and establishing the remote control, this VI allows sending or retrieving parameters 
to/from the camera. 


Connector Pane 


Value In 


error in (no error) 1 






<» 



Value Out 
Returned string 
error out 


Controls and Indicators 


IfWH Command Enumeration of the supported commands and parameters. Some "set" 
commands require a parameter that should be passed in "Value In". 

Some "get" commands retrieve the parameter either in the "Value out" or in the 
"Returned String". 

iri32ii 

Value In specifies the value to be sent with certain "set" commands 

ll~i32H Value Out returns a numeric value read from the camera according to some "get" 
commands. 


OE] 


Returned string returns, "as is" the text sent by the camera when sending some "get" 
commands. 


WriteReadSerialData .vi 

This low level function sends a textual command to the camera and reads back the answer from the camera. 
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Connector Pane 


Data To Send 
Timeout - r 
error in {no error) 



Received Data 
Success 
error out 


Controls and Indicators 

|i il Data To Send Command being sent to the camera. 


y||]] Timeout (1000) Time value in ms this VI should wait between sending the command and 
waiting for an answer. 


1 1 Received Data from the camera after sending the command. 


► tf i Success returns true if the camera understood the command. 


SerialDataLog .vi 

This VI enables or disables the generation of the log file (serial.log) containing a trace of the commands 
exchanged with the camera. By default the log is disabled. 

Connector Pane 

Log Enabled (f) 
error in (no error) 

Controls and Indicators 

irrrH Log Enabled (f) Specifies whether the log activity should be enabled or disabled. 




■ error out 


SetVideoMode.vi 


Set-up the low level camera support software to generate video test patterns. This VI can be used for testing 
purpose. 

Connector Pane 


Mode 

error in (no error) 


vmode . Success 

. error out 


Controls and Indicators 

oo Mode Specifies the mode being set to camera's video generator. 


rm| Success Confirms the video generator accepted the mode. 
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PaletteGenerator.vi 


Generate a color look-up table (lut) and its short representation. This VI should be used in conjunction with other 
Vis that require a color LUT to convert 14 bits camera data into RGB colors. 


Connector Pane 

64 K Color LUT 
Colors Samples 


Number of Samples 
Palette Type 


PGen 


Controls and Indicators 


GO Palette Type Specifies the palette type to be retrieved. These are the currently defined 
palettes: 

White Hot regular black & white palette 

Black Hot Inverted B & W palette 

Highlight B & W palette with 4 lowest entries in blue and 4 - highest entries in 

red. The palette shows saturation in the image. 

IronBow Spectrum 1 and Spectrum 2: Color ramp palettes 

Slice 10 to 12 bit B & W cyclic palettes 


ysgjj Number of Samples Number of samples (or entries) being generated as "Color 
Samples" to represent the full color LUT. 


t»»] 


64 K Color LUT Array of data being used to convert the 14 bit data into xRGB colors. 
The generated LUT has actually 65536 elements being a replication of 4 x 16384 entries. 
This allows ignoring two high order bits. 


t»»] 


Colors Samples returns an array of color being a subset of the whole Color LUT. The 
number of entries in this array is set by the input "Number of samples". 


Convertl6ToRGB.vi 


This VI converts a 16 bit image into a RGB color image using a color LUT to perform the conversion. The 
processing is basically : pixelout = ColorLUT[pixelin]. 

Connector Pane 


Image Src (16 bit) 
Imaae Dst (RGB) 
Color LUT 
error in (no error) 



Image Dst (RGB) Out 
error out 


Controls and Indicators 

|r°jrm Image Src (16 bit) Image to be converted. 

|[u 32 >| Color LUT Array of data being used to convert the 14 bit data into xRGB colors. This 
array can be build by the application or come from "PaletteGenerator.vi". 
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Image Dst (RGB) Out Image resulting from the conversion. 


ConvertArrayl6ToRGB.vi 

This VI converts a 16-bit array into a RGB color array using a color LUT to perform the conversion. The 
processing is basically: elementout = Colorl_UT[elementin]. 

Connector Pane 


116 Array 
Color LUT 
error in {no error) 


■ 4ii 



RGB Array Out 
error out 


Controls and Indicators 

I [»32;H Color LUT Array of data being used to convert the 14 bit data into xRGB colors. This 
array can be built into the application or come from "PaletteGenerator.vi" 

I [iieH 116 Array The raw pixel value before converting into RGB. 

I to 32 ] | RGB Array Out The RGB value resulting from the conversion of "116 Array" using the 
"Color LUT". 


ReadWriteFITSFile.vi 

This VI read and writes a 16 bits image into a FITS (Flexible Image Transport System) file. This VI ensures the 
management of the minimum FITS header tags. The caller can pass or retrieve the optional FITS tags. 

For more information on the FITS data format, its formal specification, and available image display tools, visit: 
http://fits.asfc.nasa.gov . 

Connector Pane 


Write (F) 
Image (16 bit) 
File Path 
Custom Tag/Value 
error in (no error) 


□-© 


= Image Out (16 bit) 
—■ nywuH n p. Success 

*"■ Tag/Value Out 
error out 


Controls and Indicators 

|L»y| Image (16 bit) The image being used for the operation. 

[L^Jj File Path File Path is the complete pathname, including drive, directory, and filename, of 
the image file to be written. 

I [*»>cH Custom Tag/Value Array of FITS tags and corresponding values to add to the FITS file 
header. It can be typically camera and/or application settings. 
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150 Write (F) Specifies if reading or writing to a file is performed. 

I | Tag/Value Out Tag and associated value read from the FITS file header. 
|»tf i| Success returns true if the read or write operation was successful. 


PVGrabDisplay. vi 

This VI is a demo capturing and displaying frames. This VI requires the IMAQ Vision package. 


PV GrabToPicture.vi 

This VI is a demo capturing and displaying frames into a LabVIEW Picture. 


GetCalibrationData.vi 

This VI gets from the camera the permanent calibration data being used to convert gray scale values into 
temperatures. The returned values can be passed to SetCalibration.vi in order to allow ConvertRawTemp.vi to 
work properly. 

Connector Pane 


error in Jno error) 



Success 
Filter Position 
Primary Calibration Coefs 
Secondary Calibration Coefs 
error out 


Controls and Indicators 


11 Filter Position : The current camera temperature range setting. 


Fibril Primary Calibration Coefs : 384 bytes of calibration data from the camera. 
Secondary Calibration Coefs : 64 bytes of calibration data from the camera. 
Success returns true if the data were read successfully. 




EZE] 


SetCalibrationData.vi 

This VI sets the permanent calibration data being used to convert gray scale values into temperature values. The 
passed data should come from GetCalibrationData.vi. This VI MUST be called successfully before calling 

ConvertRawTemp.vi. 
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Connector Pane 


Filter Position 
Primary Calibration Coefs 
Secondary Calibration Coefs 
error in [no error) 



Success 
error out 


Controls and Indicators 

IrCT Filter Position : The camera temperature range setting. 

|i il Primary Calibration Coefs : 384 bytes of calibration data from GetCalibrationData.vi. 
IfTbTH Secondary Calibration Coefs : 64 bytes of calibration data from GetCalibrationData.vi. 
»tf i| Success returns true if the passed data were consistent. 


GetCurrentT empData. vi 

This VI gets from the camera the contextual calibration data being used to convert gray scale values into 
temperatures. These values should be periodically reloaded (every 4 or 5 seconds). The returned values are 
passed along with other data to ConvertRawTemp.vi for converting gray value into temperature. 

Connector Pane 


error in {no error) ■ 



i?Conv 



<« 



■ Success 

'Temp, Operating Parameters 
-Background Temp. 

■error out 


Controls and Indicators 


^T|| Temp. Operating Parameters contains contextual data retrieved from the camera. 
»tf i| Success returns true if the data were read successfully. 


Egg n 


Background Temp, returns the estimated ambient temperature read from the camera 
sensor. This data is extracted from the Temperature Operating Parameters. This value 
can be used as an estimate of the image background temperature. 


ConvertRawT emp. vi 

This VI convert a gray value into a temperature value. Before calling this VI, permanent calibration data must be 
set by calling SetCalibrationData.vi (using the data retrieved with GetCalibrationData.vi). Also 
GetCurrentTempData.vi must be called in order to get the data required by this VI. 

Connector Pane 
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Temp. Operating Parameters 
Gray Value 
Emissivity 
Background Temperature 
error in {no error) 



Temperature (°F) 
Success 
error out 


Controls and Indicators 


|i ri Gray Value : The 14 bits pixel value to be converted in temperature. 


IrCT 


IfscTU 


IfraH 


EID 


Temp. Operating Parameters : The most recent data read from 

GetCurrentTempdata.vi. 

Emissivity : The estimated emissivity of the object to which the pixel belongs. Valid 
range is 0.1 to 1.0. If the Emissivity is unknown, use 1.0. 

Background Temperature : This parameter is optional. If not connected or zero, the 
background temperature from the camera sensor present in the Temp. Operating 
Parameters is used. 

Success returns true if the conversion was successfully performed. 


Ei32l| Temperature(°F) is the computed conversion in degrees Fahrenheit. 
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